home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 003 / bbsort.arc / BB-SORT.DOC next >
Text File  |  1986-07-29  |  2KB  |  44 lines
  1.                        ========================
  2.                         BB-SORT Documentation
  3.                        ========================
  4.  
  5.      I wrote BB-Sort because the only sort routines that I had
  6. available were either slow, or would not sort a file larger than 64K.
  7. As long as I was at it, I decided to combine data sort, reverse data
  8. sort, and alpha sort capabilities.  BB-Sort spends most of its time
  9. reading the file into memory, and after the sort, writing it back to
  10. disk.  I have tested it on a 168K file, and it sorted in less than 35
  11. seconds.  This is fast enough for me.
  12.  
  13.      The speed comes because it does the sort in memory.  The
  14. limitation is system memory.  It Will use as much memory as you have
  15. available.  I have tested it on files as large as 256k.  It can
  16. certainly sort files larger than that, but I figured that was as big
  17. as I need worry about.
  18.  
  19.     You can use it to do an alphasort on any text file. Just give it
  20. the `/H' option to tell it to sort the header text, and the `/A'
  21. option to tell it to do an alphasort.
  22.  
  23.                              Header Text
  24.  
  25.     BB-Sort considers any line that as header text if it does not
  26. contain a dash at column positions 26 & 29, and numbers at column
  27. positions 25,27,30.  These positions are standard in dBBS, RBBS, and
  28. PC-Board systems.  They are also the same column positions that DOS
  29. uses when it gives a directory.  Header Text is put at the top of the
  30. file in the order that it is found.  If you want BB-Sort to include
  31. the header text in its sort, give it the `/H' option.
  32.  
  33.                                Caution
  34.  
  35.     BB-Sort will not be able to read a line's date properly if the
  36. line has any tab chars between the first column, and the date.
  37.  
  38.  
  39. Enjoy!!
  40.  
  41.     Daniel B. Doman
  42.       7-29-86
  43.  
  44.